• .bazelignore
  • Added sphinxdocs to the ignore list to prevent Bazel from processing it in the main workspace.
• .bcr/config.yml
  • Included sphinxdocs in the moduleRoots to register it as a discoverable module for the Bazel Central Registry.
• .bcr/sphinxdocs/metadata.template.json
  • Added a new metadata file defining the sphinxdocs module's details for the Bazel Central Registry.
• .bcr/sphinxdocs/presubmit.yml
  • Added a new presubmit configuration file for the sphinxdocs module, specifying its testing matrix and commands.
• .bcr/sphinxdocs/source.template.json
  • Added a new source template file for the sphinxdocs module, detailing how its source code is fetched.
• MODULE.bazel
  • Removed stardoc as a non-development dependency.
  • Added sphinxdocs as a development dependency with a local path override to its new location.
• docs/BUILD.bazel
  • Updated load statements to reference readthedocs.bzl, sphinx.bzl, sphinx_docs_library.bzl, and sphinx_stardoc.bzl from the @sphinxdocs external module.
  • Modified renamed_srcs and deps to use the @sphinxdocs//inventories:bazel_inventory and @sphinxdocs//docs:docs_lib labels respectively.
  • Updated sphinx_build_binary dependencies to reference @sphinxdocs//src/sphinx_bzl.
• docs/conf.py
  • Updated a comment to reflect the new @sphinxdocs//:extra_defines flag syntax.
• docs/readthedocs_build.sh
  • Modified extra_env and extra_defines flags to use the @sphinxdocs// prefix for module-specific settings.
• python/private/BUILD.bazel
  • Extended default_visibility to include @sphinxdocs//:__subpackages__ to allow the new module to access private Python rules.
  • Changed the visibility of util_bzl to //visibility:public.
• sphinxdocs/.bazelrc
  • Added a new Bazel configuration file for the sphinxdocs module, including build and test settings.
• sphinxdocs/.bazelrc.deleted_packages
  • Added a new configuration file for deleted packages specific to the sphinxdocs module.
• sphinxdocs/.bazelversion
  • Added a new file specifying Bazel version 8.x for the sphinxdocs module.
• sphinxdocs/BUILD.bazel
  • Updated load statements to use relative paths for sphinx.bzl, sphinx_docs_library.bzl, sphinx_stardoc.bzl, and readthedocs.bzl within the sphinxdocs module.
  • Adjusted deps for sphinx_bzl, sphinx_docs_library_bzl, sphinx_stardoc_bzl, and readthedocs_bzl to use relative paths.
• sphinxdocs/MODULE.bazel
  • Added a new module definition for sphinxdocs, including its version, compatibility level, and dependencies like bazel_skylib, stardoc, platforms, protobuf, and rules_python with local path overrides.
• sphinxdocs/docs/BUILD.bazel
  • Updated load statements to use relative paths for util.bzl, sphinx_docs_library.bzl, and sphinx_stardoc.bzl.
  • Made docs_lib public by adding visibility = ["//visibility:public"].
  • Adjusted srcs for bzl_docs and py_api_srcs to use relative paths within the sphinxdocs module.
• sphinxdocs/docs/api/sphinxdocs/index.md
  • Updated bzl:currentfile and the main heading to reflect the new module root, changing //sphinxdocs:BUILD.bazel to //:BUILD.bazel.
• sphinxdocs/docs/api/sphinxdocs/inventories/index.md
  • Updated bzl:currentfile and the main heading to reflect the new module root, changing //sphinxdocs/inventories:BUILD.bazel to //inventories:BUILD.bazel.
• sphinxdocs/docs/readthedocs.md
  • Updated references to extra_env and extra_defines flags to use the //: prefix instead of @rules_python//sphinxdocs:.
• sphinxdocs/docs/sphinx-bzl.md
  • Updated the dependency reference for enabling the Sphinx plugin from @rules_python//sphinxdocs/src/sphinx_bzl to //src/sphinx_bzl.
• sphinxdocs/docs/starlark-docgen.md
  • Updated dependency references for sphinx_bzl plugin from @rules_python//sphinxdocs/src/sphinx_bzl to //src/sphinx_bzl.
• sphinxdocs/integration_tests/bcr/BUILD.bazel
  • Added a new build file for BCR integration tests within the sphinxdocs module.
• sphinxdocs/integration_tests/bcr/MODULE.bazel
  • Added a new module definition for BCR integration tests, including local path overrides for sphinxdocs and rules_python.
• sphinxdocs/integration_tests/bcr/conf.py
  • Added a new Sphinx configuration file for the integration tests.
• sphinxdocs/integration_tests/bcr/index.md
  • Added a new Markdown file for the Sphinxdocs example documentation.
• sphinxdocs/inventories/BUILD.bazel
  • Updated the load statement for sphinx_inventory to use a relative path within the sphinxdocs module.
• sphinxdocs/private/BUILD.bazel
  • Updated load statements for py_binary and py_library to reference @rules_python//python.
  • Adjusted default_visibility to //:__subpackages__.
  • Updated comments to reflect the new module structure.
  • Added a new bzl_library target for util_bzl.
  • Modified deps for sphinx_docs_library_macro_bzl, sphinx_bzl, sphinx_stardoc_bzl, and readthedocs_bzl to use relative paths or @rules_python//python.
• sphinxdocs/private/readthedocs.bzl
  • Updated load statements for py_binary and add_tag to reference @rules_python//python and //private respectively.
  • Modified _INSTALL_MAIN_SRC to use //private:readthedocs_install.py.
  • Updated add_tag call to use //:readthedocs_install.
  • Changed deps for py_binary to @rules_python//python/runfiles.
• sphinxdocs/private/sphinx.bzl
  • Updated load statements for py_binary and add_tag to reference @rules_python//python and //private respectively.
  • Modified _SPHINX_BUILD_MAIN_SRC and _SPHINX_SERVE_MAIN_SRC to use //private.
  • Updated add_tag calls to use //:sphinx_build_binary and //:sphinx_docs.
  • Changed deps for py_binary to @rules_python//python/runfiles.
  • Updated default values for _extra_defines_flag, _extra_env_flag, and _quiet_flag to use //:.
• sphinxdocs/private/sphinx_docs_library_macro.bzl
  • Updated load statement for add_tag to use //private:util.bzl.
  • Modified add_tag call to use //:sphinx_docs_library.
• sphinxdocs/private/sphinx_stardoc.bzl
  • Updated load statements for add_tag and sphinx_docs_library to use //private.
  • Modified add_tag calls to use //:sphinx_stardocs and //:sphinx_stardoc.
  • Updated default value for _proto_to_markdown to use //private:proto_to_markdown.
• sphinxdocs/private/util.bzl
  • Added a new utility file containing BZLMOD_ENABLED, copy_propagating_kwargs, and add_tag functions.
• sphinxdocs/readthedocs.bzl
  • Updated load statement for _readthedocs_install to use a relative path within the sphinxdocs module.
• sphinxdocs/sphinx.bzl
  • Updated load statement for _sphinx_build_binary, _sphinx_docs, and _sphinx_inventory to use a relative path within the sphinxdocs module.
• sphinxdocs/sphinx_docs_library.bzl
  • Updated load statement for _sphinx_docs_library to use a relative path within the sphinxdocs module.
• sphinxdocs/sphinx_stardoc.bzl
  • Updated load statement for _sphinx_stardoc and _sphinx_stardocs to use a relative path within the sphinxdocs module.
• sphinxdocs/src/sphinx_bzl/BUILD.bazel
  • Updated load statement for py_library to reference @rules_python//python.
• sphinxdocs/src/sphinx_bzl/bzl.py
  • Updated a comment to reflect the new //:quiet=false flag syntax.
• sphinxdocs/tests/proto_to_markdown/BUILD.bazel
  • Updated load statement for py_test to reference @rules_python//python.
  • Modified deps for proto_to_markdown_test to use //private:proto_to_markdown_lib.
• sphinxdocs/tests/proto_to_markdown/proto_to_markdown_test.py
  • Updated the import statement for proto_to_markdown to use a relative path.
• sphinxdocs/tests/sphinx_docs/BUILD.bazel
  • Updated load statement for sphinx_build_binary and sphinx_docs to use a relative path within the sphinxdocs module.
• sphinxdocs/tests/sphinx_stardoc/BUILD.bazel
  • Updated load statements for py_test, sphinx_build_binary, sphinx_docs, sphinx_stardoc, and sphinx_stardocs to reference @rules_python//python and use relative paths.
  • Modified renamed_srcs to use //inventories:bazel_inventory.
• sphinxdocs/tests/sphinx_stardoc/index.md
  • Updated bazel run commands to use relative paths for the docs.serve and docs targets.
• sphinxdocs/tests/sphinx_stardoc/sphinx_output_test.py
  • Updated the import statement for sphinx_stardoc to use a relative path.
• sphinxdocs/tests/sphinx_stardoc/xrefs.md
  • Updated the cross-reference path for GenericInfo to use a relative path.

• The pull request was initiated by rickeylev with the goal of modularizing sphinxdocs.
• New Bazel module infrastructure for sphinxdocs was created, including MODULE.bazel, .bazelrc, .bazelversion, and BCR configuration files.
• Extensive refactoring of BUILD.bazel files and Starlark code was performed across rules_python and the new sphinxdocs module to align with the new module boundaries.
• Dependencies and load statements were updated to correctly reference targets either within the new sphinxdocs module or from rules_python as an external dependency.
• A util.bzl file was added to sphinxdocs/private, likely consolidating common Starlark functions for the new module.

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.